ui-state

Table of Contents
​uiStateUpdaters​
​addNotificationUpdater​
​cleanupExportImage​
​DEFAULT_EXPORT_DATA​
​DEFAULT_EXPORT_IMAGE​
​DEFAULT_MAP_CONTROLS_FEATURES​
​hideExportDropdownUpdater​
​INITIAL_UI_STATE​
​loadFilesErrUpdater​
​loadFilesUpdater​
​openDeleteModalUpdater​
​removeNotificationUpdater​
​setExportDataTypeUpdater​
​setExportDataUpdater​
​setExportFilteredUpdater​
​setExportImageDataUri​
​setExportImageSetting​
​setExportSelectedDatasetUpdater​
​showExportDropdownUpdater​
​startExportingImage​
​toggleMapControlUpdater​
​toggleModalUpdater​
​toggleSidePanelUpdater​
​toggleSplitMapUpdater​
​DEFAULT_EXPORT_HTML​
​setUserMapboxAccessTokenUpdater​
uiStateUpdaters
Updaters for uiState reducer. Can be used in your root reducer to directly modify kepler.gl's state. Read more about Using updaters​
Examples
import keplerGlReducer, {uiStateUpdaters} from 'kepler.gl/reducers';
// Root Reducer
const reducers = combineReducers({
 keplerGl: keplerGlReducer,
 app: appReducer
});
​
const composedReducer = (state, action) => {
 switch (action.type) {
   // click button to close side panel
   case 'CLICK_BUTTON':
     return {
       ...state,
       keplerGl: {
         ...state.keplerGl,
         foo: {
            ...state.keplerGl.foo,
            uiState: uiStateUpdaters.toggleSidePanelUpdater(
              uiState, {payload: null}
            )
         }
       }
     };
 }
 return reducers(state, action);
};
​
export default composedReducer;
addNotificationUpdater
Add a notification to be displayed. Existing notification is going to be updated in case of matching ids.
Action: addNotification​
Parameters
state Object uiState
action Object 
action.payload Object 
Returns Object nextState
cleanupExportImage
Delete cached export image
Action: cleanupExportImage​
Parameters
state Object uiState
Returns Object nextState
DEFAULT_EXPORT_DATA
Default initial exportData settings
Type: Object​
Properties
selectedDataset string Default: '',
dataType string Default: 'csv',
filtered boolean Default: true,
config boolean deprecated
data boolean used in modal config export. Default: false
DEFAULT_EXPORT_IMAGE
Default image export config
Type: Object​
Properties
ratio string Default: 'SCREEN',
resolution string Default: 'ONE_X',
legend boolean Default: false,
imageDataUri string Default: '',
exporting boolean Default: false
error boolean Default: false
DEFAULT_MAP_CONTROLS_FEATURES
A list of map control visibility and whether is it active.
Type: Object​
Properties
visibleLayers Object Default: {show: true, active: false}
mapLegend Object Default: {show: true, active: false}
toggle3d Object Default: {show: true}
splitMap Object Default: {show: true}
hideExportDropdownUpdater
Hide side panel header dropdown, activated by clicking the share link on top of the side panel
Action: hideExportDropdown​
Parameters
state Object uiState
Returns Object nextState
INITIAL_UI_STATE
Default initial uiState
Type: Object​
Properties
readOnly boolean Default: false
activeSidePanel string Default: 'layer'
currentModal (string | null) Default: 'addData'
datasetKeyToRemove (string | null) Default: null
visibleDropdown (string | null) Default: null
exportImage Object Default: DEFAULT_EXPORT_IMAGE​
exportData Object Default: DEFAULT_EXPORT_DATA​
mapControls Object Default: DEFAULT_MAP_CONTROLS​
activeMapIndex number defines which map the user clicked on. Default: 0
loadFilesErrUpdater
Handles load file error and set fileLoading property to false
Action: loadFilesErr​
Parameters
state  
error Object 
error.error  
Returns Object nextState
loadFilesUpdater
Fired when file loading begin
Action: loadFiles​
Parameters
state Object uiState
Returns Object nextState
openDeleteModalUpdater
Toggle active map control panel
Action: openDeleteModal​
Parameters
state Object uiState
action Object 
action.payload string dataset id
Returns Object nextState
removeNotificationUpdater
Remove a notification
Action: removeNotification​
Parameters
state Object uiState
action Object 
action.payload String id of the notification to be removed
Returns Object nextState
setExportDataTypeUpdater
Set data format for exporting data
Action: setExportDataType​
Parameters
state Object uiState
action Object 
action.payload string one of 'text/csv'
Returns Object nextState
setExportDataUpdater
Whether to including data in map config, toggle between true or false
Action: setExportData​
Parameters
state Object uiState
Returns Object nextState
setExportFilteredUpdater
Whether to export filtered data, true or false
Action: setExportFiltered​
Parameters
state Object uiState
action Object 
action.payload boolean 
Returns Object nextState
setExportImageDataUri
Set exportImage.setExportImageDataUri to a image dataUri
Action: setExportImageDataUri​
Parameters
state Object uiState
action Object 
action.payload string export image data uri
Returns Object nextState
setExportImageSetting
Set exportImage.legend to true or false
Action: setExportImageSetting​
Parameters
state Object uiState
$1 Object 
$1.payload  
Returns Object nextState
setExportSelectedDatasetUpdater
Set selected dataset for export
Action: setExportSelectedDataset​
Parameters
state Object uiState
action Object 
action.payload string dataset id
Returns Object nextState
showExportDropdownUpdater
Hide and show side panel header dropdown, activated by clicking the share link on top of the side panel
Action: showExportDropdown​
Parameters
state Object uiState
action Object 
action.payload string id of the dropdown
Returns Object nextState
startExportingImage
Set exportImage.exporting to true
Action: startExportingImage​
Parameters
state Object uiState
Returns Object nextState
toggleMapControlUpdater
Toggle active map control panel
Action: toggleMapControl​
Parameters
state Object uiState
action Object action
action.payload string map control panel id, one of the keys of: DEFAULT_MAP_CONTROLS​
action.payload.panelId  
action.payload.index   (optional, default 0)
Returns Object nextState
toggleModalUpdater
Show and hide modal dialog
Action: toggleModal​
Parameters
state Object uiState
action Object 
action.payload (string | null) id of modal to be shown, null to hide modals. One of:-   DATA_TABLE_ID​
​DELETE_DATA_ID​
​ADD_DATA_ID​
​EXPORT_IMAGE_ID​
​EXPORT_DATA_ID​
​ADD_MAP_STYLE_ID​
Returns Object nextState
toggleSidePanelUpdater
Toggle active side panel
Action: toggleSidePanel​
Parameters
state Object uiState
action Object 
action.payload (string | null) id of side panel to be shown, one of layer, filter, interaction, map. close side panel if null
Returns Object nextState
toggleSplitMapUpdater
Handles toggle map split and reset all map control index to 0
Action: toggleSplitMap​
Parameters
state  
Returns Object nextState
DEFAULT_EXPORT_HTML
Type: Object​
Properties
exportMapboxAccessToken string Default: null, this is used when we provide a default mapbox token for users to take advantage of
userMapboxToken string Default: '', mapbox token provided by user through input field
setUserMapboxAccessTokenUpdater
whether to export a mapbox access to HTML single page
Action: setUserMapboxAccessToken​
Parameters
state Object uiState
action Object 
action.payload string 
Returns Object nextState
combine
vis-state
Last modified 1yr ago