https://help.smartchart.cn/en/docs/5.Parameters/ Recent content on Smartchart开发手册 Hugo -- gohugo.io https://help.smartchart.cn/en/docs/5.Parameters/ParameterWriting/ Mon, 01 Jan 0001 00:00:00 +0000 https://help.smartchart.cn/en/docs/5.Parameters/ParameterWriting/ Introduction # SmartChart’s parameter mechanism is the core of chart linkage, filters, and data permissions. By embedding “magic comment” syntax in SQL, you can dynamically control query conditions without modifying SQL structure. Use Cases # Chart linkage effects Data service API development Row-level data permission control Magic Syntax Quick Reference # Syntax Description Example $param_name Parameter placeholder $city → replaced with passed value /* ... $param_name ... */ Conditional code block Active when param exists, ignored when not -- Line ignore marker Ignores entire line after $param__value Value match switch $type__1 means active when type=1 Basic Principles # 1. https://help.smartchart.cn/en/docs/5.Parameters/ChartLinkageDrill/ Mon, 01 Jan 0001 00:00:00 +0000 https://help.smartchart.cn/en/docs/5.Parameters/ChartLinkageDrill/ Introduction # Chart linkage is the most common interactive feature in SmartChart: click one chart to auto-refresh others. Implemented via dataset “linkage settings” or by calling ds_setParam + ds_refresh in chart code. Linkage Functions Quick Reference # Function Description ds_setParam('param_name', value) Set parameter value ds_refresh(index) Refresh specified dataset ds_param('param_name') Get passed parameter value del filter_param['param_name'] Delete parameter (cancel linkage) Dataset Preparation # Write SQL in linked datasets using parameter syntax (see “Parameter Writing”): select . https://help.smartchart.cn/en/docs/5.Parameters/FilterGuide/ Mon, 01 Jan 0001 00:00:00 +0000 https://help.smartchart.cn/en/docs/5.Parameters/FilterGuide/ Introduction # Filters are the most common interactive components in dashboards. SmartChart auto-identifies filter components through special id naming convention (id_select__name__) and handles linkage logic. Implementation Flow # Step Operation Description 1 Create dataset Write SQL to get filter options 2 Edit JS Generate <select> control with id="id_select__name__" 3 Configure linkage Click title → set linked dataset index Standard Implementation # Create a filter list dataset: select xxxx as city from tablename. https://help.smartchart.cn/en/docs/5.Parameters/ComponentCustomLinkage/ Mon, 01 Jan 0001 00:00:00 +0000 https://help.smartchart.cn/en/docs/5.Parameters/ComponentCustomLinkage/ Introduction # SmartChart has built-in single-select filters, but for multi-select, checkboxes, custom HTML controls and other personalized needs, you need to write some JS code. This chapter introduces how to customize complex filter linkage effects. Custom Linkage Development Pattern # Step Operation Code 1 Generate HTML control dom__name__.innerHTML = ... 2 Bind event $('#id_btn').unbind('click').click(...) 3 Get control value $('#input_id').val() 4 Set parameter ds_setParam('param_name', value) 5 Refresh dataset ds_refresh(index) Example # Create a new chart component, write query: