Component Party 标志

Component Party 中文版

响应式

声明状态

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";

@Component({
  selector: "app-name",
  template: `<h1>你好 {{ name() }}</h1>`,
})
export class NameComponent {
  name = signal("张三");
}

Ember Octane 标志 Ember Octane

<h1>你好 {{this.name}}</h1>

更新状态

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";

@Component({
  selector: "app-name",
  template: `<h1>你好 {{ name() }}</h1>`,
})
export class NameComponent {
  name = signal("张三");

  constructor() {
    this.name.set("李四");
  }
}

Ember Octane 标志 Ember Octane

<h1>你好 {{this.name}}</h1>

计算属性

Angular Renaissance 标志 Angular Renaissance

import { Component, computed, signal } from "@angular/core";

@Component({
  selector: "app-double-count",
  template: `<div>{{ doubleCount() }}</div>`,
})
export class DoubleCountComponent {
  count = signal(10);

  doubleCount = computed(() => this.count() * 2);
}

Ember Octane 标志 Ember Octane

<div>{{this.doubleCount}}</div>

模板语法

最简模板

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";

@Component({
  selector: "app-hello-world",
  template: `<h1>你好，世界</h1>`,
})
export class HelloWorldComponent {}

Ember Octane 标志 Ember Octane

<h1>你好，世界</h1>

样式

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";

@Component({
  selector: "app-css-style",
  template: `
    <h1 class="title">我是红色的</h1>
    <button style="font-size: 10rem">我是一个按钮</button>
  `,
  styles: `
    .title {
      color: red;
    }
  `,
})
export class CssStyleComponent {}

Ember Octane 标志 Ember Octane

/* using: https://github.com/salsify/ember-css-modules */
.title {
  color: red;
}

DOM循环

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";

@Component({
  selector: "app-colors",
  template: `
    <ul>
      @for (color of colors; track color) {
        <li>{{ color }}</li>
      }
    </ul>
  `,
})
export class ColorsComponent {
  colors = ["红", "绿", "蓝"];
}

Ember Octane 标志 Ember Octane

<ul>
  {{#each (array "红" "绿" "蓝") as |color|}}
    <li>{{color}}</li>
  {{/each}}
</ul>

点击事件

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";

@Component({
  selector: "app-counter",
  template: `
    <p>计数器: {{ count() }}</p>
    <button (click)="incrementCount()">+1</button>
  `,
})
export class CounterComponent {
  count = signal(0);

  incrementCount() {
    this.count.update((count) => count + 1);
  }
}

Ember Octane 标志 Ember Octane

<p>计数器: {{this.count}}</p>
<button {{on "click" this.incrementCount}}>+1</button>

DOM引用

Angular Renaissance 标志 Angular Renaissance

import {
  afterNextRender,
  Component,
  ElementRef,
  viewChild,
} from "@angular/core";

@Component({
  selector: "app-input-focused",
  template: `<input type="text" #inputRef />`,
})
export class InputFocusedComponent {
  inputRef = viewChild.required<ElementRef<HTMLInputElement>>("inputRef");

  constructor() {
    afterNextRender({ write: () => this.inputRef().nativeElement.focus() });
  }
}

Ember Octane 标志 Ember Octane

<input {{this.autofocus}} />

条件渲染

Angular Renaissance 标志 Angular Renaissance

import { Component, computed, signal } from "@angular/core";

const TRAFFIC_LIGHTS = ["红灯", "黄灯", "绿灯"];

@Component({
  selector: "app-traffic-light",
  template: `
    <button (click)="nextLight()">下一个灯</button>
    <p>现在亮着的是: {{ light() }}</p>
    <p>
      你应该
      @switch (light()) {
        @case ("红灯") {
          <span>停下</span>
        }
        @case ("黄灯") {
          <span>慢行</span>
        }
        @case ("绿灯") {
          <span>赶紧走</span>
        }
      }
    </p>
  `,
})
export class TrafficLightComponent {
  lightIndex = signal(0);

  light = computed(() => TRAFFIC_LIGHTS[this.lightIndex()]);

  nextLight() {
    this.lightIndex.update((index) => (index + 1) % TRAFFIC_LIGHTS.length);
  }
}

Ember Octane 标志 Ember Octane

<button {{on "click" this.nextLight}}>下一个灯</button>
<p>现在亮着的是: {{this.light}}</p>
<p>
  你应该
  {{#if (eq this.light "红灯")}}
    停下
  {{else if (eq this.light "黄灯")}}
    慢行
  {{else if (eq this.light "绿灯")}}
    赶紧走
  {{/if}}
</p>

生命周期

组件加载时

Angular Renaissance 标志 Angular Renaissance

import { Component, OnInit, signal } from "@angular/core";

@Component({
  selector: "app-page-title",
  template: `<p>页面标题: {{ pageTitle() }}</p>`,
})
export class PageTitleComponent implements OnInit {
  pageTitle = signal("");

  ngOnInit() {
    this.pageTitle.set(document.title);
  }
}

Ember Octane 标志 Ember Octane

<p>页面标题: {{(this.pageTitle)}}</p>

组件卸载时

Angular Renaissance 标志 Angular Renaissance

import { Component, OnDestroy, signal } from "@angular/core";

@Component({
  selector: "app-time",
  template: `<p>当前时间: {{ time() }}</p>`,
})
export class TimeComponent implements OnDestroy {
  time = signal(new Date().toLocaleTimeString());

  timer = setInterval(
    () => this.time.set(new Date().toLocaleTimeString()),
    1000,
  );

  ngOnDestroy() {
    clearInterval(this.timer);
  }
}

Ember Octane 标志 Ember Octane

<p>当前时间: {{this.time}}</p>

组件组合

组件Props传参

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";
import { UserprofileComponent } from "./userprofile.component";

@Component({
  selector: "app-root",
  imports: [UserprofileComponent],
  template: `
    <app-userprofile
      name="张三"
      [age]="20"
      [favouriteColors]="['green', 'blue', 'red']"
      [isAvailable]="true"
    />
  `,
})
export class AppComponent {}

Ember Octane 标志 Ember Octane

<UserProfile
  @name="张三"
  @age={{20}}
  @favouriteColors={{array "green" "blue" "red"}}
  @isAvailable={{true}}
/>

向父组件emit事件

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";
import { AnswerButtonComponent } from "./answer-button.component";

@Component({
  selector: "app-root",
  imports: [AnswerButtonComponent],
  template: `
    <p>你快乐吗?</p>

    <app-answer-button (yes)="onAnswerYes()" (no)="onAnswerNo()" />

    <p style="font-size: 50px">{{ isHappy() ? "😀" : "😥" }}</p>
  `,
})
export class AppComponent {
  isHappy = signal(true);

  onAnswerYes() {
    this.isHappy.set(true);
  }

  onAnswerNo() {
    this.isHappy.set(false);
  }
}

Ember Octane 标志 Ember Octane

<p>你快乐吗?</p>
<AnswerButton @onYes={{this.handleYes}} @onNo={{this.handleNo}} />
<p style="font-size: 50px;">{{if this.isHappy "😀" "😥"}}</p>

slot插槽

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";
import { FunnyButtonComponent } from "./funny-button.component";

@Component({
  selector: "app-root",
  imports: [FunnyButtonComponent],
  template: `<app-funny-button>点我!</app-funny-button>`,
})
export class AppComponent {}

Ember Octane 标志 Ember Octane

<FunnyButton> 点我! </FunnyButton>

slot插槽内容

Angular Renaissance 标志 Angular Renaissance

import { Component } from "@angular/core";
import { FunnyButtonComponent } from "./funny-button.component";

@Component({
  selector: "app-root",
  imports: [FunnyButtonComponent],
  template: `
    <app-funny-button />

    <app-funny-button>这是传到slot的内容!</app-funny-button>
  `,
})
export class AppComponent {}

Ember Octane 标志 Ember Octane

<FunnyButton />
<FunnyButton>这是传到slot的内容!</FunnyButton>

上下文

Angular Renaissance 标志 Angular Renaissance

import { Component, inject } from "@angular/core";
import { UserService } from "./user.service";
import { UserProfileComponent } from "./user-profile.component";

@Component({
  imports: [UserProfileComponent],
  providers: [UserService],
  selector: "app-root",
  template: `
    <h1>欢迎回来, {{ userService.user().username }}</h1>
    <app-user-profile />
  `,
})
export class AppComponent {
  protected userService = inject(UserService);
}

Ember Octane 标志 Ember Octane

<UserProfile />

表单输入

输入框

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";
import { FormsModule } from "@angular/forms";

@Component({
  imports: [FormsModule],
  selector: "app-input-hello",
  template: `
    <p>{{ text() }}</p>
    <input [(ngModel)]="text" />
  `,
})
export class InputHelloComponent {
  text = signal("");
}

Ember Octane 标志 Ember Octane

<p>{{this.text}}</p>
<input value={{this.text}} {{on "input" this.handleInput}} />

复选框

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";
import { FormsModule } from "@angular/forms";

@Component({
  imports: [FormsModule],
  selector: "app-is-available",
  template: `
    <input id="is-available" type="checkbox" [(ngModel)]="isAvailable" />
    <label for="is-available">这是一个checkbox</label>
  `,
})
export class IsAvailableComponent {
  isAvailable = signal(false);
}

Ember Octane 标志 Ember Octane

<input
  id="is-available"
  type="checkbox"
  checked={{this.isAvailable}}
  {{on "change" this.handleChange}}
/>
<label for="is-available">这是一个checkbox</label>

单选框

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";
import { FormsModule } from "@angular/forms";

@Component({
  imports: [FormsModule],
  selector: "app-pick-pill",
  template: `
    <div>你选择了: {{ picked() }}</div>

    <input id="blue-pill" type="radio" value="blue" [(ngModel)]="picked" />
    <label for="blue-pill">蓝色</label>

    <input id="red-pill" type="radio" value="red" [(ngModel)]="picked" />
    <label for="red-pill">红色</label>
  `,
})
export class PickPillComponent {
  picked = signal("red");
}

Ember Octane 标志 Ember Octane

<div>你选择了: {{this.picked}}</div>

<input
  id="blue-pill"
  type="radio"
  value="blue"
  checked={{eq this.picked "blue"}}
  {{on "change" this.handleChange}}
/>
<label htmlFor="blue-pill">蓝色</label>

<input
  id="red-pill"
  type="radio"
  value="red"
  checked={{eq this.picked "red"}}
  {{on "change" this.handleChange}}
/>
<label htmlFor="red-pill">红色</label>

选择器

Angular Renaissance 标志 Angular Renaissance

import { Component, signal } from "@angular/core";
import { FormsModule } from "@angular/forms";

@Component({
  imports: [FormsModule],
  selector: "app-color-select",
  template: `
    <select [(ngModel)]="selectedColorId">
      @for (let color of colors; track color) {
        <option [value]="color.id" [disabled]="color.isDisabled">
          {{ color.text }}
        </option>
      }
    </select>
  `,
})
export class ColorSelectComponent {
  selectedColorId = signal(2);

  colors = [
    { id: 1, text: "红" },
    { id: 2, text: "蓝" },
    { id: 3, text: "绿" },
    { id: 4, text: "灰", isDisabled: true },
  ];
}

Ember Octane 标志 Ember Octane

<select {{on "change" this.select}}>
  {{#each this.colors as |color|}}
    <option
      value={{color.id}}
      disabled={{color.isDisabled}}
      selected={{eq color.id this.selectedColorId}}
    >
      {{color.text}}
    </option>
  {{/each}}
</select>

Web应用特性

渲染应用

Angular Renaissance 标志 Angular Renaissance

<!doctype html>
<html>
  <body>
    <app-root></app-root>
  </body>
</html>

Ember Octane 标志 Ember Octane

缺少代码片段 帮助我们改进 Component Party Component Party 标志
在 Github 上贡献

fetch获取数据

Angular Renaissance 标志 Angular Renaissance

import { Injectable } from "@angular/core";
import { httpResource } from "@angular/common/http";

@Injectable({ providedIn: "root" })
export class UserService {
  readonly usersResource = httpResource<UserResponse>(
    () => "https://randomuser.me/api/?results=3",
  );
}

export interface UserResponse {
  results: User[];
  info: any;
}

export interface User {
  name: {
    title: string;
    first: string;
    last: string;
  };
  picture: {
    large: string;
    medium: string;
    thumbnail: string;
  };
}

Ember Octane 标志 Ember Octane

{{#let (this.fetchUsers) as |request|}}
  {{#if request.isLoading}}

    <p>正在获取用户信息……</p>

  {{else if request.error}}

    <p>获取用户信息出错</p>

  {{else}}

    <ul>
      {{#each request.users as |user|}}
        <li>
          <img src={{user.picture.thumbnail}} alt="user" />
          <p>{{user.name.first}} {{user.name.last}}</p>
        </li>
      {{/each}}
    </ul>

  {{/if}}
{{/let}}