Terminology Reference
To help you understand and use Qingkuai more efficiently, this section collects common terms and concepts used throughout the documentation. Whether you're a beginner just getting started with the framework or an advanced user diving into the source code, this reference will help clarify terminology and avoid ambiguity and misunderstanding.
Component File
A component file is a file with the .qk extension. Each component file represents a component declaration.
See: Introduction, Component Basics
Interpolation Attribute
Interpolation attributes refer collectively to a set of special attributes, including directives, dynamic attributes, reference attributes, and events.
See: Compilation Directives, Dynamic Attributes, Reference Attributes, Event Handling, Component Attributes
Interpolation Block
An interpolation block refers to any place in the template content where JavaScript/TypeScript expressions are embedded within a pair of curly braces. This includes the value parts of all interpolation attributes and the text interpolation sections.
See: Text Interpolation
Embedded Script Block
An embedded script block refers to sections enclosed by lang-js or lang-ts tags. They are used to embed script content that requires compilation.
See: Introduction, Design Philosophy
Embedded Language Tags
Embedded language tags refer to the following 8 tags: lang-js, lang-ts, lang-css, lang-scss, lang-sass, lang-less, lang-stylus, lang-postcss. These are used to embed script and style content that needs to be compiled.
See: Introduction, Stylesheets
Built-in Helper Methods
Built-in helper methods refer to the six identifiers — rea, stc, der, wat, Wat, waT — that can be used directly in component files without prior declaration. The first three are used to create reactive state declarations, and the latter three are used to conveniently register watchers for reactive states. All of them are compile-time markers; the Qingkuai compiler translates them into internal method calls.
See: Reactive Declarations, Reactivity Depth, Derived Reactive State, Destructuring Reactive Declarations, Watchers, Pre Watchers, Sync Watchers
Built-in Objects
Built-in objects refer to the two identifiers — refs and props — that are accessible without prior declaration in component files. They are used respectively to store and access reference attributes and other property values passed externally to the component.
See: Component Attributes