当前位置: 首页 > 后端技术 > PHP

OctoberCMS-8-Components

时间:2023-03-30 02:59:39 PHP

ComponentsComponents这里我们称之为组件。组件是可配置的构建元素。可以附加到Pages(页面)、Layouts(布局)、Partials(组件)。组件是October的核心功能。每个组件都可以扩展网站的功能。组件可以在页面上输出HTML代码,但这不是主要功能。组件的一个重要功能是处理ajax请求,处理表单提交回调,处理页面执行周期。允许将变量注入页面或实现站点安全。介绍启用组件。如果是在后台管理系统中,可以选择组件面板,拖拽添加组件到页面、组件、布局中。如果采用文本编辑方式,可以在对应模板的配置部分添加组件对应模板的名称。例如:下面的例子演示了如何将todolist组件添加到页面中。title="Componentsdemonstration"url="/components"[demoTodo]maxItems=20==...当你引用Components时,它会自动创建一个与Components名称匹配的Page变量(前面例子中的demoTodo)。提供HTML标记的组件可以使用标记{%component%}在页面上呈现,如下所示:{%component'demoTodo'%}如果将两个具有相同名称的组件分配给页面和布局,则页面中的组件将覆盖布局中的组件。组件别名如果有两个同名的已注册组件,可以通过组件的完全限定名来引用组件,并为其起一个别名:[October\Demo\Components\TododemoTodoAlias]maxItems=20第一个参数是类名,第二个参数是注入Page时使用的组件的别名。如果为组件指定别名,则在引用组件时可以在页面代码中的任何位置使用它。下一个示例引用了组件别名:{%component'demoTodoAlias'%}允许为同一组件定义多个别名以在同一页面上使用一个组件的多个实例。[demoTodotodoA]maxItems=10[demoTodotodoB]maxItems=20组件使用外部属性值默认会在定义组件的配置部分初始化属性值,属性值此时是静态的,如下图:[demoTodo]maxItems=20==...但是有一种方法是使用外部参数来初始化组件属性。它可以是URL参数或Partial组件参数。使用{{paramName}}从外部变量加载值的语法:[demoTodo]maxItems={{maxItems}}==...假设在上面的例子中,组件demoTodo被用在一个widget中,那么widget的variablemaxItems**会初始化组件的变量:{%partial'my-todo-partial'maxItems='10'%}如果是URL参数,使用方式略有不同:使用{{:paramName}}name后跟冒号(:)开头的语法[demoTodo]maxItems={{:maxItems}}==...组件对应的页面在配置部分,应该有对应的URL参数定义:url="/todo/:maxItems"在October之后,您可以使用Inspector工具为Components属性分配外部值。在Inspector中,您不需要输入带有大括号的参数名称。Inspector中的每个字段右侧都有一个图标,用于打开外部参数名称编辑器。输入paramName部分变量或:paramNameURL参数的参数名称。自定义默认标记http://octobercms.com/docs/cm...后续补充